WPS 加载项开发 > 表格 API 参考 > Names > 方法 > Names.Add 方法
为单元格区域定义新名称。

语法

表达式.Add(Name, RefersTo, Visible, MacroType, ShortcutKey, Category, NameLocal, RefersToLocal, CategoryLocal, RefersToR1C1, RefersToR1C1Local)

表达式   一个表示 Names 对象的变量。

参数

名称 必选/可选 数据类型 说明
Name 可选 Variant 如果未指定 NameLocal 参数,则指定要用作名称的英文文本。名称不能包括空格,并且不能设置为单元格引用的格式。
RefersTo 可选 Variant 如果未指定 RefersToLocal、RefersToR1C1 和 RefersToR1C1Local 参数,则说明名称引用的内容(使用 A1 格式表示法以英文表示)。
注释
如果引用不存在,则返回 Nothing。
Visible 可选 Variant True 指定将名称定义为可见。False 指定将名称定义为隐藏。已隐藏的名称不会在“定义名称”、“粘贴名称”或“转到”对话框中显示。默认值为 True。
MacroType 可选 Variant 由以下值之一确定的宏类型:
  • 1 - 用户定义函数(Function 过程)
  • 2 - 宏(Sub 过程)
  • 3 或省略 - 无(该名称不引用用户定义函数或宏)
ShortcutKey 可选 Variant 指定宏的快捷键。必须是单个字母,例如“z”或“Z”。仅适用于命令宏。
Category 可选 Variant 如果 MacroType 参数等于 1 或 2,则此参数为宏或函数的分类。该分类在“函数向导”中使用。可以用数字(从 1 开始)或名称(以英文指定)引用现有的分类。如果指定的分类不存在,ET 将创建新分类。
NameLocal 可选 Variant 如果未指定 Name 参数,则指定要用作名称的本地化的文本。名称不能包括空格,并且不能设置为单元格引用的格式。
RefersToLocal 可选 Variant 如果未指定 RefersTo、RefersToR1C1 和 RefersToR1C1Local 参数,则说明名称引用的内容(使用 A1 格式表示法以本地化的文本表示)。
CategoryLocal 可选 Variant 如果未指定 Category 参数,则指定标识自定义函数分类的本地化的文本。
RefersToR1C1 可选 Variant 如果未指定 RefersTo、RefersToLocal 和 RefersToR1C1Local 参数,则说明名称引用的内容(使用 R1C1 格式表示法以英文表示)。
RefersToR1C1Local 可选 Variant 如果未指定 RefersTo、RefersToLocal 和 RefersToR1C1 参数,则说明名称引用的内容(使用 R1C1 格式表示法以本地化的文本表示)。

返回值
一个表示新名称的 Name 对象。

示例

此示例为活动工作簿中 Sheet1 上的区域 A1:D3 定义一个新名称。

注释
如果工作表 Sheet1 不存在,则返回 Nothing。

示例代码
function MakeRange(){
    ActiveWorkbook.Names.Add ("tempRange", "=Sheet1!$A$1:$D$3")
}


请参阅